Connecting to Source Control Repositories

You can connect erwin DM to source control repositories via erwin Mart Portal. This enables you to save Forward Engineering (FE) scripts for a Mart model to your source control repository.

You cannot store FE scripts or DDL on a erwin Mart Portal but only erwin models.

With source control support you can implement:

  • DevOps adoption
  • collaboration with team members
  • version control
  • workflow management
  • data integrity

Pushing FE scripts to a repository involves:

  1. Connecting erwin DM to erwin Mart Portal
  2. Connecting erwin DM to a repository
  3. Opening a Mart model and committing FE scripts

To summarize, following is the workflow to commit FE scripts.

A repository may be hosted on GitLab, GitHub, Bitbucket, or Azure DevOps. For a successful connection to these repositories, following are the prerequisites:

  • GitHub Scope: Ensure that the following minimum scope is configured.
  • GitLab Scope: Ensure that the following minimum scope is configured.
  • Bitbucket Scope: Ensure that the following minimum scope is configured.
  • Azure DevOps Scope: Ensure that the following minimum scope is configured.
  • erwin Mart: Ensure that,
    • erwin DM is connected to erwin Mart Portal. For more information, refer to the Connect to Mart topic.

      • Ensure that the following minimum permission is configured.

      This permission is not available for Viewer profile.

  • Personal Access Token: Ensure that you have created the required personal access token. To know how to create personal access tokens for GitLab, refer to the GitLab documentation, for GitHub, refer to the GitHub documentation and for Azure DevOps, refer to the Azure DevOps documentation.

Once, these prerequisites are in place, to connect your repositories to erwin DM, follow these steps:

  1. On the ribbon, click Mart.

  2. Click Git Connections.

    3. The Git Connection Manager opens.

    By default, the Connection tab opens.

  3. Enter appropriate values in the fields. Refer to the following table for field descriptions.
    4. Field Name Description Additional Information
    Connection Name Specifies a user-defined connection name

    For example, TechPubsConnect.

    You can create multiple connections one for each repository.
    Git Hosting Service Specifies the source control hosting service to which erwin DMconnects

    You can connect to a repository hosted on one of the following services:

    • GitLab

    • GitHub

    • Bitbucket

    • Azure DevOps
    User Name Specifies the username to log on to the hosting service This field is not mandatory.
    Password Specifies the password to log on to the hosting service This field is not mandatory.
    Personal Access Token Specifies the personal access token to connect to the hosting service  

    Access Token

    Specifies the personal access token to connect to the Bitbucket hosting service

    This option is available only when the Git Hosting Service option is set to Bitbucket.

    You can click the Access Token field label to learn about creating tokens and their types.

    Org/User Option

    Specifies whether the organization name or username should be use for your connection

     

    Org/User Name

    Depending on your selection in Org/User Option field, enter organization name or username

     
  4. Click Next.

    5. The Repositories tab appears and displays the list of repositories available to your source control account.

  5. Select the repository where you want to push forward engineering scripts.

    6. You can also filter the list of repositories using the Available Repositories field.

  6. Click Next.

    7. The Branches tab appears and displays the list branches available in the selected repository.

  7. Select the branch where you want to push forward engineering scripts and then click OK.

    8. On successful connection, the connection name appears under Saved Connections.

While setting up your connection, you may encounter the following error:

To resolve this error, follow these steps:

  1. On your system, go to Control Panel > Internet Options > Advanced Tab.
  2. Under the Security category, clear the Warn if changing between secure and not secure mode check box.

  3. Click OK.
  4. Close and reopen erwin DM.
  5. Connect erwin DM to erwin Mart Portal.
  6. Open the Git Connection Manager and configure your source control connection.

Once you are connected to a repository, you can commit FE scripts.